Version History - for new features see WHATSNEW.TXT
1.00 released 1. December 1995
1.01 release 27. December 1995
1.02 released 14. January 1996
A native Delphi component to take the pain out of backing up your applications
data.
(C) UDEEDV GmbH 1995,1996
Just drop this component on your form, set some of its properties and with one
line of code you have a complete backup to any drive you like.
Features:
* Multi volume backup on disks and removable media
* Data is safely backed up using CRC-32 block checksums
* Included fast data compression with modified LZSS algorithm
* File selection with wildcards, optional including subdirs
* File dates and attributes restored
* Optional deletion of existing files on target drive
* Calculates percentage of work done yet
* Multi language support (German, English supported yet)
* Many events accessible through your application
* name of backup archives variable
* non existing directories will be created
* GetInfo retrieves all files in a backup set
* calculated remaining time to complete the task
* selective restore to restore only files selected
Shareware version is fully functional but runs only under Borland IDE. Registered users will get a full version, source code and one year free updates. Registration is US$ 50 or DM 69.
Register via SWREG #8741 Uploaded by the author.
To contact: CIS 100112,2777. Arnold Ude
How to use UBACKUP
==================
Installation
============
First copy at least the files
UBACKUP.DCU, UBACKUP.DCR, UDEBIB.DCU, LZSSLIB.DCU to a single directory
of your choice. To install UBACKUP to your development system,
call "Options..Install new component" from the Borland IDE.
Add the file UBACKUP.DCU and rebuild your component library.
The new component should be in your button bar under the section UWARE.
Clicking the right mouse button you can configurate your
button bar to move the UBACKUP-Icon in any section you like.
Quickstart of using UBACKUP
===========================
UBACKUP provides an easy way to backup the files of your application to any
drive or disk. To use UBACKUP follow the steps:
1.) Drop the UBACKUP component on your form
2.) Set the following properties:
Use the FilesToBackup property to specify what to backup:
Use one line per specification, each line can contain
a fully qualified filename with or without wildcards (*,?). If you
want UBACKUP to backup all matching files in Subdirs too just add
to the line a /S.
Set Compression to true, if you want the being compressed during backup
Set FileList to the path and name of your file name list file
OR
Set FilesToBackup to an expression describing the files you want
to backup e.g. c:\test\*.pas
Set BackupOn to the Drive and optional path of the destination of
your backup
Set Overwrite to true, if you want existing files being overwritten
without confirmation
Set Description to any descriptional text of the backup set or
leave it blank
Set Language to English or German as you prefer for eventually
shown message boxes
4.) Insert anywhere in your code (perhaps as reaction of a button being
clicked) the line:
Ubackup1.Backup;
5.) Compile and run
To have your files being restored to the original destination just write a line
Ubackup1.Restore;
Short Technical Documentation of UBACKUP
========================================
Properties
==========
Compression : Boolean; This property allows the user to decide, if UBACKUP
should compress the data during the backup and
decompress it during restore. If this property is set
to true UBACKUP tries to compress the data block by
block. Every block will only be written in compressed
format if the compression actually saved space.
This is done to avoid overhead for already compressed
files (eg ZIP archives). During the process of
restore UBACKUP decompresses every compressed block
automatically. The value of this property is only
relevant during backup.
BackupOn : String; This property specifies the destination of the backup
respectively the source for the restore of files.
You can specify a drive letter and optional a path
where the backup files should go. To have your files
backed up to the first disk drive set this
property to A:\
FileList : String; You can (since Version 1.01) use two ways of setting
which files to backup. If you set the
UseExternalFileList property to true, you can use
this property :
Put all the filenames of the files you want to be
backed up in to a textfile which name you specify
with this property. Every filename goes in one line
of the filelist. You should include Drive and
complete path with each file. This property and the
way UBACKUP handles the files to backup will be
improved with the next version. This property is
only relevant during backup operations. During
restore all files are currently restored to where
they came frome.
Overwrite : Boolean; This property determines, if existing files during
backup or restore are overwritten without
confirmation. If you set this property to true,
eventually existing files on your backup destination
will be deleted without reconfirmation ! To avoid
any "accidents" the backup destination "C:\"
wont be accepted together with the Overwrite
property set to true. During restore this property
determines if existing version of the files to
be restored will be replaced. If you set this
option to false you will generally be asked if you
really want to delete files.
Description : String; This property give space to name your backup set.
During backup is the value of this property
written as descriptional header to your backupr.
During restore this property is undefined.
FileAtWork : String; This property is only valid during the backup /
restore process. It∩s value shows the name of the
file actually processed. If you react on the
OnNextFile event described later than you are
able to inform the user of the things going on.
Language : TLanguages; This property allows to choose between different
languages for the text being used in the message
boxes presented to the user. If you set some of
the notification events described later on, you
can do the presentation of warnings etc. To the
user yourself inside your application. As far you
can choose between German and English language
here. More language on request to come.
Percent : Integer; This value is only defined during backup / restore
processes and shows the percentage of work done.
Answer : (Yes,No,All) This value indicates the preferred action of the
